XXXXmmmmMMMMeeeennnnuuuuSSSShhhheeeellllllll - The MenuShell widget class
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
#include <Xm/MenuShell.h>
VVVVEEEERRRRSSSSIIIIOOOONNNN
This page documents Motif 2.1.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
The MenuShell widget is a custom OverrideShell widget. An
OverrideShell widget bypasses mmmmwwwwmmmm when displaying itself. It
is designed specifically to contain Popup or Pulldown menu
panes.
Most application writers never encounter this widget if they
use the menu-system convenience functions, XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPooooppppuuuuppppMMMMeeeennnnuuuu
or XXXXmmmmCCCCrrrreeeeaaaatttteeeePPPPuuuullllllllddddoooowwwwnnnn MMMMeeeennnnuuuu, to create a Popup or Pulldown menu
pane. The convenience functions automatically create a
MenuShell widget as the parent of the menu pane. However, if
the convenience functions are not used, the application
programmer must create the required MenuShell. In this case,
it is important to note that the parent of the MenuShell
depends on the type of menu system being built.
+o If the MenuShell is for the top-level Popup menu pane,
the MenuShell's parent must be the widget from which
the Popup menu pane is popped up.
+o If the MenuShell is for a menu pane that is pulled
down from a Popup or another Pulldown menu pane, the
MenuShell's parent must be the Popup or Pulldown menu
pane.
+o If the MenuShell is for a menu pane that is pulled
down from a MenuBar, the MenuShell's parent must be
the MenuBar.
+o If the MenuShell is for a Pulldown menu pane in an
OptionMenu, the MenuShell's parent must be the
OptionMenu's parent.
Setting XXXXmmmmNNNNhhhheeeeiiiigggghhhhtttt, XXXXmmmmNNNNwwwwiiiiddddtttthhhh, or XXXXmmmmNNNNbbbboooorrrrddddeeeerrrrWWWWiiiiddddtttthhhh for either a
MenuShell or its child sets that resource to the same value
in both the parent and the child. An application should
always specify these resources for the child, not the
parent.
For the managed child of a MenuShell, regardless of the
value of the shell's XXXXmmmmNNNNaaaalllllllloooowwwwSSSShhhheeeellllllllRRRReeeessssiiiizzzzeeee, setting XXXXmmmmNNNNxxxx or
XXXXmmmmNNNNyyyysets the corresponding resource of the parent but does
not change the child's position relative to the parent.
XXXXmmmmNNNNbbbbuuuuttttttttoooonnnnRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeis initialized to the value of
XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttFFFFoooonnnnttttLLLLiiiisssstttt. If the value of
XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttFFFFoooonnnnttttLLLLiiiisssstttt is NULL, XXXXmmmmNNNNbbbbuuuuttttttttoooonnnnRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeis
initialized by looking up the parent hierarchy of
the widget for an ancestor that holds the
_X_m_Q_T_s_p_e_c_i_f_y_R_e_n_d_e_r_T_a_b_l_e trait. If such an ancestor
is found, XXXXmmmmNNNNbbbbuuuuttttttttoooonnnnRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee is initialized to
the XXXXmmmmBBBBUUUUTTTTTTTTOOOONNNN____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE value of the ancestor
widget. If no such ancestor is found, the default
is implementation dependent. Refer to
XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee(3) for more information on the